home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-20 / ki6lo521.zip / ADDENDUM.DOC < prev    next >
Text File  |  1990-05-01  |  19KB  |  357 lines
  1.                       Version 5.2x User Manual Addendum
  2.  
  3.  
  4.    CHANGES / ADDITIONS TO PREVIOUS V5.20
  5.  
  6.        The following are a list of changes and/or addito\ions made to
  7.    version 5.20 since its release in January 1990. Some of these items
  8.    were not ready for release in verison 5.20 and others were cleanup or
  9.    adjustments to existing features. Each is noted as to whether it was
  10.    a change or addition, also where in the v5.2 manual the topic is found.
  11.  
  12.    1) Program name change
  13.  
  14.       All pages - Change
  15.       All filenames shown as LOG52.EXE should be changed to LOG521.EXE
  16.       All filenames shown as LOG52.OVL should be changed to LOG521.OVL
  17.  
  18.    2) DATA FIELD ENTRY ENABLED TOGGLE FEATURE
  19.  
  20.        page 20 - Addition - Data Input Field Status Selection Page
  21.        page 53 - Addition - Menu option "SET ACTIVE FIELD STATUS"
  22.  
  23.         Some users were requiring that some of the non-required fields
  24.      on the Data Input form be disabled so it would speed up data entry
  25.      in their particular case. I decided to enable the user to turn off
  26.      (or on) any or all of the non-required fields in the log file. All
  27.      fields in the top box on the Data Entry form ARE required and can't
  28.      be turned off.
  29.  
  30.         During initialization (or when v5.21 is first started and the
  31.      USER_LOG.CFG configuration file from v5.20 is detected), a screen
  32.      like the one shown below is displayed. Perform the functions as called
  33.      out in the accompanying text to toggle the fields ON to OFF or vice
  34.      versa. If a field is toggled to OFF when the ESCAPE key is pressed,
  35.      the 'OFF' label will appear in the area on the DATA INPUT form where
  36.      you would normally enter input data. It will appear there everytime
  37.      you select the ADD DATA option until you reset the field to the ON status.
  38.  
  39.         To reset any or all fields, select the "SET ACTIVE FIELD STATUS"
  40.      option on the UPDATE USER DATA MENU from the FILE MAINTENANCE MENU.
  41.      Perform the required actions as before, saving with ESCAPE when done.
  42.  
  43.                       *****************************
  44.  
  45.                          DATA ENTRY FIELD STATUS
  46.                       +-------------------------+
  47.                       | 1 - NAME .......... ON  |  * All default to ON
  48.                       | 2 - CITY .......... ON  |
  49.                       | 3 - STATE ......... ON  |
  50.                       | 4 - COUNTRY ....... ON  |
  51.                       | 5 - CQ ZONE ....... ON  |
  52.                       | 6 - ITU ZONE ...... ON  |
  53.                       | 7 - REPORT SENT ... ON  |
  54.                       | 8 - REPORT RECV ... ON  |
  55.                       | 9 - ANTENNA ....... ON  |
  56.                       | A - QSL SENT ...... ON  |
  57.                       | B - QSL RECVD ..... ON  |
  58.                       | C - MISC FIELD .... ON  |
  59.                       +-------------------------+
  60.  
  61.       The window above shows the current status for ALLOWING data input to
  62.       the non-required fields of a log file. Pressing the NUMBER or LETTER
  63.       associated with the fieldname will toggle the ACTIVE status of the
  64.       field. If the status shows 'ON', you will be able to enter data in
  65.       that field when using the DATA INPUT form in the ADD QSO option. If
  66.       'OFF' is shown, the field will be disable till you reset it to 'ON'.
  67.       Set fields to desired status and press ESCAPE to save conditions and
  68.       EXIT to previous menu.   NOTE : Default is all fields set to 'ON'.
  69.  
  70.                       ***************************
  71.  
  72.  
  73.    3) 'HOTKEYS' OPTIONS - FUNCTION KEYS AND WHAT THEY DO
  74.  
  75.        page 24 - Addition
  76.  
  77.                   F7:CALL  -  QUICK CALLSIGN CHECKING
  78.  
  79.            Realizing that the ability to do a fast check for a callsign
  80.        on-the-fly was needed and had been noted by several v5.20 users,
  81.        I added this option for use in all areas of the program EXCEPT
  82.        while using the 'browse' function in the UPDATE LOG or QUERY modes.
  83.        Pressing F7 will give you a prompt as shown below. You will enter
  84.        the callsign to find (up to 12 characters).
  85.  
  86.      ENTER CALLSIGN TO FIND (12 CHR MAX - <CR only> ABORTS) : ___________
  87.  
  88.        Please note : If you enter only part of a callsign, say "VK4" or
  89.        "WB0" you will get ALL calls that start with the partial callsign.
  90.        If you had 20 contacts with VK4 stations and 5 of them were to VK4AA,
  91.        entering VK4 would find 20 contacts, while entering VK4AA would find
  92.        only 5. This is handy to see if you may have worked a prefix or area
  93.        already.
  94.  
  95.           If any entries are found, a window is opened on top of whatever
  96.        you doing and ALL the matching QSO's are shown in the window, listing
  97.        the first 9 characters of the CALLSIGN, the date-time-freq-mode of the
  98.        QSO, the operators name (if any), QSL information and the country. If
  99.        more a definitive 'look' at any particular QSO data is required, move
  100.        the highlighted line to the QSO in question and press RETURN. Another
  101.        window is opened and all data for the QSO is shown along with any
  102.        COMMENTS. Press any key and the second window closes and you are back
  103.        at the list window. Select another or press ESCAPE to return to the
  104.        activity at hand before F7 was pressed. You may press F7 again for
  105.        another callsign or group of callsigns.
  106.  
  107.        PLEASE NOTE : This is only a 'Viewing' option - no printing done here.
  108.  
  109.  
  110.        page 26 - Change
  111.        ALT-T key - TOGGLE THE AUTO DATE/TIME STAMPING DURING ADD QSO'S
  112.  
  113.        The label for stating the status of the AUTOTIME feature was moved
  114.        from the right side of the menu to below the menu. It also shows
  115.        the status for both ON and OFF. The operation is the same as before.
  116.  
  117.        page 27 - Change
  118.        ALT-U - TOGGLE CALLSIGN DUPING OPTION ON / OFF
  119.  
  120.        The label for stating the status of the DUPING feature was moved
  121.        from the right side of the menu to below the menu. It also shows
  122.        the status for both ON, OFF, FULL or QUICK (see below).
  123.  
  124.        page 28 - Addition
  125.        ALT-Y - TOGGLE DUPING MODE - FULL / QUICK
  126.  
  127.        In order to allow faster duping without data retrival and copying
  128.        as done in v5.20, another DUPING mode was added for v5.21. This mode
  129.        called QUICK MODE (the original DUPING mode was renamed FULL MODE)
  130.        will allow the entry to be duped and you are warned if another call
  131.        of the same exact type (not like the F7 partial callsign entry
  132.        above) is found. If one is found, the following message is shown:
  133.  
  134.           +----------------------------------------------------------+
  135.           | DUPE CALL - Press RETURN to keep, Any other for NEW call |
  136.           +----------------------------------------------------------+
  137.  
  138.        Press RETURN, the callsign is kept and the data entry process
  139.        continues. Press any other key and the callsign is removed from the
  140.        input block and you are ready for another callsign entry.
  141.  
  142.            For the FULL DUPING MODE, it works the same as duping in v5.20
  143.        except if you select to not search for more matching entries, the
  144.        current callsign is kept and the entry process continues on to the
  145.        date field.
  146.  
  147.  
  148.        page 31 - Change
  149.        Example of Data Entry Form
  150.  
  151.          The below diagram shows the new DUPING mode label placement. The
  152.       status of the DUPING is shown at the 'FULL' location. Pressing ALT-Y
  153.       will toggle the DUPING MODE while DUPING is ON. It has no effect while
  154.       DUPING is OFF.
  155.  
  156.  F1:HELP  F2:TONE  F3:KEYS  F4:TIME  F5:PRFX  F6:MODE  F7:CALL  F8:DBF  ADD
  157.    +--------------------------------------------------------------------+
  158.    |                            QSO INFORMATION                         |
  159.    +--------------------------------------------------------------------+
  160.    |           Callsign : [            ]   Duping : FULL (Alt-Y)        |
  161.    |                                                                    |
  162.    |       Date (M/D/Y) : [12/10/89]       Time (Zulu) : [1930]         |
  163.    |                                                                    |
  164.    |              Frequency : [  0.000 Mhz]     Mode : [SSB]            |
  165.    |                                                                    |
  166.    +--------------------------------------------------------------------+
  167.  
  168.     page 41 - Change
  169.  
  170.                CONNECTING THE INDIVIDUAL CONDITION STATEMENTS
  171.  
  172.         Once the field name,  compare symbol and target value  have  been
  173.    entered, you will be shown another selection window asking if you want
  174.    to 'connect' this statement to another logically.  Remember  the  pre-
  175.    vious  example  where  we  used  an  'AND'  and  an  'OR'  to  connect
  176.    statements. You will be shown this window:
  177.  
  178.    +-------------------------------------------------------------------+
  179.    |  Previous condition AND this condition must be TRUE for match     |
  180.    |  Previous condition AND NOT this condition must be TRUE for match |
  181.    |  Previous condition OR this condition must be TRUE for match      |
  182.    |  Previous condition OR NOT this condition must be TRUE for match  |
  183.    |  No more entries needed in this condition set                     |
  184.    +-------------------------------------------------------------------+
  185.  
  186.     Now there are 5 choice here instead of 3. The menu has been increased
  187.     in size and text to help make the decision about which one to use. The
  188.     process of 'connecting' the statements together is the same as in v5.20.
  189.  
  190.             ******************************************************
  191.  
  192.             Additional information and clarification on the use of
  193.  
  194.                         QUERYING THE LOGBOOK FILES
  195.  
  196.         Several users have called stating that the new v5.2x query system
  197.    seems to be slower than the v5.11 query interface.  Well, it is if you
  198.    use the  data  access  time  as  the  only  reference  to  performance
  199.    improvement. In the following text, I will explain why the the new in-
  200.    terface seems slower and what can be done to make it  perform  to  the
  201.    maximum capability.
  202.  
  203.    To BUILD or not to BUILD :
  204.  
  205.         In v5.2x, you have the  capability to build  a 'filtering' string
  206.    or condition statement which could be saved to a  disk file  for later
  207.    recall.  The  condition  statement  could be a simple comparison or an
  208.    elaborate 'filter' to ignore all but a specific few  records.  Whether
  209.    to build a string or not is up to the user.  If it is not built,  then
  210.    the program will react in 1 of 2 ways.
  211.  
  212.         Condition #1 - If entering the QUERY menu from the MAIN Menu  and
  213.    having  not  built  a  previous  condition statement once in the QUERY
  214.    menu, if the VIEW option is selected then ALL records will be shown on
  215.    the  screen.  Since  there  is no condition to limit the access to the
  216.    records,  all present records are displayed in the ordering you select
  217.    from the 'INDEX BY .... ?' menu.
  218.  
  219.         Condition #2 - If a condition statement has been previously built
  220.    and another is NOT built prior to VIEWING and if  the  statement  pre-
  221.    viously built wasn't 'ALL' (see manual for meaning of 'ALL'), then the
  222.    display will be limited to those records that 'pass-thru'  the  filter
  223.    (i.e. match the condition statement).
  224.  
  225.         I would strongly advise that for casual 'browsing' (VIEWING) that
  226.    the condition statement be 'ALL' if one is to be built.  Also that the
  227.    INDEXING order be that of a natural logbook (i.e.   chronologically by
  228.    DATE and TIME),  since this will help group all daily contact and will
  229.    correspond with your recollection of events and QSO's easier.
  230.  
  231.                         ***************************
  232.                    Remember that F7 is also available for
  233.                    FAST checking of callsigns in log file.
  234.                         ***************************
  235.  
  236.         Also  be  aware  that  if the condition statement is too limiting
  237.    (many facets to match) that the system will take longer since it  must
  238.    check  each  record  field against the matching statement for any pos-
  239.    sible match.  In a log of several thousand QSO's,  you could  setup  a
  240.    condition  that  would possibly take several minutes to search through
  241.    all the records.  To avoid this type of delayed searching,  select the
  242.    index  that  closest matches the type of data you will be looking for.
  243.    Select 'INDEXED by COUNTRY' if you are going to be limiting your found
  244.    records  by  country  name.  If there is not close index or if you are
  245.    unsure, select NO index and let the log go in natural order.
  246.  
  247.  
  248.    Using the F3 FIND key :
  249.  
  250.         Using the F3 find key in the wrong place at the wrong  time  will
  251.    not  hurt  anything,  but  it  could eat up a lot of valuable computer
  252.    time. For instance, if you are searching for all records that have the
  253.    country  equal to,  say ENGLAND,  and pressed F3 for a quick find of a
  254.    callsign that is not in ENGLAND,  then some strange things can happen.
  255.    Let me clarify the last statement.  The strange things are a result of
  256.    you forcing the program to try and do something it is  easily  capable
  257.    of doing,  but during this stage of the game, it is somewhat taxing on
  258.    the program's performance.
  259.  
  260.         What  could  possibly happen is this.  If the program  finds  the
  261.    callsign,  it will go to that record position in the log file, put the
  262.    QSO data on the query display screen at the line where the highlighted
  263.    box  was  at  when  the quick find was requested (F3 pressed) and then
  264.    continue from the callsign matching record and  display  records  that
  265.    originally matched the condition statement in use,  till the screen is
  266.    full  or the end of the log file if found, which ever comes first.  If
  267.    you  have  several thousand  records  and  just  searched  through and
  268.    filled the screen,  which could  take a little while depending on  the
  269.    complexity of the condition statement,  the program has to now research
  270.    the log file filling the screen again. This is a repeat of time already
  271.    used and hence a degradation of system performance. By limiting the use
  272.    of the F3 key,  whose originally  intent was a quick way to jump around
  273.    in  a 'full' browse (remember 'ALL'), you can eliminate wasted time and
  274.    speed up performance.
  275.  
  276.         Also,  if the record in which the callsign  was  found  does  NOT
  277.    match  the  condition statement,  then when the display is scrolled to
  278.    cause that record to leave the displayed area,  scrolling back to that
  279.    record  will  cause THAT callsign record data to NOT be displayed.  It
  280.    doesn't match so therefore it is not displayed.  It is  displayed  the
  281.    first time simply because we forced it to be displayed by using the F3
  282.    FIND function. Once it is removed from the screen, it is not displayed
  283.    again unless you repeat the F3 action.
  284.  
  285.    To summarize, a few key points and some Do's/Don'ts are listed below:
  286.  
  287.         1) Use 'ALL' as the condition statement for casual browsing.
  288.  
  289.         2)  A complex condition statement will most likely cause the sys-
  290.         tem to slow down in searching since more fields are  involved  in
  291.         the search. With a slow system and many entries, the system could
  292.         effectively slow to a crawl.
  293.  
  294.         3) If the system seems to be stuck or not responding as you think
  295.         it should, DO NOT keep banging on the keyboard. Instead let the
  296.         system 'catch up' to a full page of records on screen or allow it
  297.         to come to a point where it is waiting on you, then press ESCAPE to
  298.         leave that browse and rethink your query statements. Are they too
  299.         limiting for the expected speed and performance.
  300.  
  301.         4)  Selecting  an  INDEX other than DATE and TIME (natural order)
  302.         will cause the search time to increase.  You may  avoid  this  by
  303.         matching,  as close as possible,  the INDEX key field to the data
  304.         being searched for.
  305.  
  306.         5) When 'browsing' and searching for  callsigns,  etc.  with  F3,
  307.         select  the  DATE/TIME  index for a log file and the PREFIX index
  308.         order for the DX INFO file,  and have the condition statement set
  309.         to  'ALL'.  This  will give the maximum speed performance of your
  310.         system.
  311.  
  312.         6) Larger logs take longer to search and if a  complex  condition
  313.         statement is applied, this time could be several minutes, depending
  314.         on the log size and what you are looking for.
  315.  
  316.         7)  For  maximum  time  use,  do  most of your querying while not
  317.         operating since query searches can be quite time consuming. Use F7
  318.         for on-the-fly entry checks.
  319.  
  320.         8) Whenever searching  for  matching  keywords  in  the  COMMENTS
  321.         field,  be  prepared  to allow a larger amount of time since each
  322.         word or phrase in each COMMENTS field must  be  compared  to  the
  323.         condition statement.
  324.  
  325.         9)  Don't expect a 4 Mhz 8088 machine with a slow hard disk to be
  326.         a optimum performer in a large query situation.  Any machine will
  327.         only do its best. A 4mhz 8088 can't possible give the same searching
  328.         performance as a 20mhz 80286 can!
  329.  
  330.         10) Experiment  with  different  query  conditions and record the
  331.         results for later comparisons.  You will discover what situations
  332.         to avoid with your system's setup.
  333.  
  334.  
  335.         Version 5.2x query interface is very powerful.  It will allow you
  336.    to find almost any data configuration  you  will  need  in  ham  radio
  337.    logging.  The  performance level is many times that of v5.11 and hence
  338.    there may be a few situations in which the previous  version  has  the
  339.    edge  when it comes to speed.  But don't be fooled in to thinking that
  340.    because v5.11 does something faster that  it  was  a  better  program.
  341.    Many,  many hours  of design and testing/tweaking have gone into v5.2x
  342.    and I hope that everyone can master the query interface to obtain  the
  343.    maximum performance from it.  It requires a small amount of experience
  344.    to really benefit from it.  Besides it never hurts to learn  something
  345.    new.
  346.  
  347.         If   you   still   are   having  problems  with  the  performance
  348.    expectations,  send me a copy of you log file and a letter of what you
  349.    are  trying  to do.  I will take a look at it and get back to you with
  350.    help.
  351.  
  352.  
  353.  
  354.    73's Gene KI6LO
  355.  
  356.  
  357.